System.Collections.ObjectModel.KeyedCollection<TKey,TItem>. ChangeItemKey-Methode

Dieser Artikel enthält ergänzende Hinweise zur Referenzdokumentation für diese API.

Die ChangeItemKey(TItem, TKey) Methode ändert den eingebetteten itemSchlüssel nicht; er ersetzt einfach den im Nachschlagewörterbuch gespeicherten Schlüssel. newKey Wenn sich der in den Schlüssel eingebettete itemSchlüssel unterscheidet, können Sie daher nicht mithilfe des von GetKeyForItemihnen zurückgegebenen Schlüssels darauf zugreifenitem.

Diese Methode führt nichts aus, wenn das KeyedCollection<TKey,TItem> Nachschlagewörterbuch nicht vorhanden ist.

Jeder Schlüssel in einem KeyedCollection<TKey,TItem> muss eindeutig sein. Ein Schlüssel kann nicht sein null.

Diese Methode ist ein O(1)-Vorgang.

Hinweise für Implementierungen

Bevor Sie den in ein Element eingebetteten Schlüssel ändern, müssen Sie diese Methode aufrufen, um den Schlüssel im Nachschlagewörterbuch zu aktualisieren. Wenn der Schwellenwert für die Wörterbucherstellung -1 ist, ist das Aufrufen dieser Methode nicht erforderlich.

Machen Sie die ChangeItemKey Methode nicht als öffentliche Methode einer abgeleiteten Klasse verfügbar. Der Missbrauch dieser Methode versetzt das Nachschlagewörterbuch mit Elementschlüsseln aus der Synchronisierung. Wenn Sie z. B. den Schlüssel auf null einen anderen Wert festlegen, werden dem Nachschlagewörterbuch mehrere Schlüssel für ein Element hinzugefügt. Diese Methode intern verfügbar machen, um veränderbare Elementschlüssel zuzulassen: Wenn sich der Schlüssel für ein Element ändert, wird diese Methode verwendet, um den Schlüssel im Nachschlagewörterbuch zu ändern.